8.1.2 법정화폐 지급명령 생성

#간단한설명 : 현금(법정화폐)결제(충전)주문받기

요청방법 : POST
요청 인터페이스: https://gateway-domain/wallet-trade-merchant/v1/receive/cash/payment/create
요청 미디어 유형(JSON 데이터 형식)Content-Type: application/json

**참고: 이러한 유형의 주문에 대한 콜백 프로세스 중에 당사 플랫폼의 결제 수신 지연으로 인해 주문 시간이 초과되어 콜백이 실패할 수 있습니다. 그러나 결제가 완료되면 시스템은 성공적인 콜백을 자동으로 재발행합니다. 따라서 판매자는 상태 = "SUCCESS"(주문 성공) 콜백만 처리하면 됩니다. **

요청 매개변수

매개변수 이름	유형	필수	매개변수 의미	매개변수 설명
`key`	`string`	예	판매자 키	API키
`localOrderId`	`string`	예	판매자 플랫폼 현지 주문 번호	판매자 플랫폼은 로컬에서 고유한 주문 번호를 생성합니다
`localUserId`	`string`	아니요	판매자 플랫폼 로컬 사용자 ID	판매자 플랫폼 로컬 사용자 ID
`notifyUrl`	`string`	아니요	콜백 주소	주문이 성공적으로 완료되면 API 콜백을 통해 가맹점 주소가 통보됩니다. (콜백 내용은 하단 참조)
`successRedirectUrl`	`string`	아니요	점프 주소	성공 후 자동으로 해당 주소로 점프
`channelCode`	`string`	예	채널 코드	문서 8.1.1 인터페이스를 통해 채널 코드(channelCode 필드) 가져오기
`currency`	`string`	예	통화	가격 통화 주문
`amount`	`number`	예	금액	주문가격
`localUserRealName`	`string`	아니요	로컬 사용자의 실명
`sign`	`string`	예	서명	자세한 내용은 서명 알고리즘을 참조하세요.

json 샘플 요청

{
 "key": "dNNTJZpgFVWlYrVv",
 "localOrderId": "conantest344",
 "localUserId": "conan",
 "notifyUrl": "http://127.0.0.1:8080/merchant-demo/notify/test",
 "isBlockchain": true,
 "channelCode":"tencentest9",
 "currency": "CNY",
 "amount": "100",
 "localUserRealName":"柯南",
 "sign": "9662c0f104123b0ccac049108f174589"
}

응답 JSON 예시

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
           "orderId": 352950471221317,
           "localOrderId": "conantest344",
           "uiUrl": "http://im.topup.dianfus.dx.com/imserver/chat/Yy9kQ3IvVXNta3BwWE5sUzUvYVM3M2hHU0UrNjlnSzRjdVpGa1BHWmR1RUdLU0daa3pDNjZqbm1QOTRlUnRULzI5TmNyWFhjV2xJc3ZGZFVzdTFWY2tkWHF1Tk1yeUxDajFod01QRk83K2FrVnIvRm1YY0ZpUzBOK001NEZXbXhzd0ZxdzhPUVFlaGlaTCttbFdML04wb3VPZ3kvUDFkdHJISlhwVjlXVE1JPQ=="
           }
}

응답 데이터 매개변수 설명

매개변수 이름	유형	매개변수 의미
`orderId`	`long`	주문번호
`localOrderId`	`string`	판매자 플랫폼 현지 주문 번호
`uiUrl`	`string`	결제링크 주소

콜백 세부정보

**참고: 이러한 유형의 주문을 처리하는 판매자가 콜백 알림을 처리하면 당사 플랫폼에서 결제 수신이 지연되어 주문 수집 시간이 초과되어 실패한 주문에 대한 콜백 알림이 트리거될 수 있습니다. 실제로 금액이 입금되면 시스템에서 성공적인 재발행을 자동으로 호출합니다. ** **따라서 이러한 유형의 주문에 대해 판매자는 상태가 "SUCCESS"(주문 성공)인 콜백만 최종 유효한 결과로 처리하면 됩니다. **

콜백 방법은 POST application/json입니다.

콜백 매개변수 JSON화 예시

{
 "amount":"100",
 "currency":"CNY",
 "localOrderId":"conantest344",
 "merchantId":302992856974,
 "merchantUserId":"conan",
 "notifyTime":1757577957437,
 "orderCreateTime":1757577574425,
 "orderId":"352950471221317",
 "paidAmount":"100",
 "status":"SUCCESS",
 "type":"PAYMENT",
 "isReissue":"true",
 "sign":"774720acbacafca99af62b98d72154d3",
 "key":"9yUreYgTRtit39Dy"
}

매개변수 이름	유형	참여 서명	매개변수 의미	매개변수 설명
`amount`	`decimal`	예	주문금액
`currency`	`string`	예	통화
`localOrderId`	`string`	예	판매자 지역 주문 번호
`merchantId`	`string`	예	판매자 ID
`merchantUserId`	`string`	예	판매자 플랫폼 로컬 사용자 ID
`notifyTime`	`long`	예	콜백 시간	밀리초
`orderCreateTime`	`long`	예	주문 생성 시간	밀리초
`orderId`	`string`	예	주문번호
`paidAmount`	`decimal`	예	결제금액
`status`	`string`	예	주문현황	성공: 완료됨 \| 실패: 실패
`type`	`string`	예	주문 유형	PAYMENT 결제, WITHDRAW 출금
`isReissue`	`boolean`	예	재발행	사실 예
`sign`	`string`	아니요	MD5 서명	자세한 내용은 서명 알고리즘을 참조하세요.
`key`	`string`	예	판매자 키

콜백 알림을 받으면 처리가 완료된 후 메시지가 성공적으로 수신 및 처리되었음을 나타내는 성공 문자열을 직접 반환해 주세요. 시스템이 성공 응답을 받은 후에는 더 이상 콜백을 반복적으로 보내지 않습니다. 예상된 응답을 받지 못한 경우(성공이 반환되지 않거나 예외가 반환됨) 시스템은 단계적 재시도 메커니즘에 따라 최대 14회 재시도하여 콜백 알림을 다시 보냅니다. 현재 재시도 간격은 다음과 같습니다. 15대, 15대, 30대, 180년대, 600년대, 1200년대, 1800년대, 1800년대, 1800년대, 3600년대, 10800년대, 10800년대, 21600년대, 21600년대

요청 매개변수​

json 샘플 요청​

응답 데이터 매개변수 설명​

콜백 세부정보​

콜백 방법은 POST application/json입니다.​